home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dormn210.zip / DORMENU.DOC < prev    next >
Text File  |  1992-05-27  |  11KB  |  222 lines
  1.  
  2.                                  D O R M E N U
  3.                                   Version 2.10
  4.                              Release Date: May 29, 1992
  5.  
  6.                    (C) Copyright 1989,1992 - All Rights Reserved
  7.  
  8.                  developed & written By D.J. Cheeks and L.E.Fox
  9.  
  10.                                  The Modem Zone
  11.                                 108 Curtis Street
  12.                              Middletown, Ohio  45044
  13.  
  14.                       (513) 424-7529 (DUAL) / 424-5820 (HST)
  15.                                 424-8347 (CompuCom)
  16.                             Voice support  424-6553
  17.                             FAX  424-5820
  18.  
  19.                           Documentation edited by L.E.Fox, D.J.Cheeks
  20.  
  21.     
  22.     Overview
  23.     ~~~~~~~~
  24.     User selects a menu item from bbs doors list, which will then run
  25.     DorMenu. The menu file that you created will be shown to the user.
  26.     The user then chooses a selection. DorMenu reads the .DAT file
  27.     (ie. ARCADE.DAT) counting the lines read until the number of lines
  28.     read matches the selection made by the users, or end of the dat file
  29.     is reached. If a match was found then DorMenu checks to see if the
  30.     time and security levels have been included, if the time or security
  31.     has been included then DorMenu will compare the users time and/or
  32.     security level to those in the .DAT file. If time and security are
  33.     included then Dormenu will first compare the time to insure that the
  34.     caller has enough time remaining, then will check to see that the
  35.     users security is equal to or greater than the .DAT file security
  36.     level. You can do any combination with the time and security. If
  37.     DorMenu passes these test then the name that was read in from the
  38.     .DAT file will be loaded into the batch file name that is in the
  39.     .CNF file, DorMenu then exits and the next line in the batch file
  40.     after DorMenu will execute the batch file whose name is in the .cnf
  41.     file. If you've included the line "if exist door.bat door" in the
  42.     files then DorMenu will reload else the bbs will be reloaded.
  43.  
  44.     Files included in this ZIP:
  45.     ~~~~~ ~~~~~~~~ ~~ ~~~~ ~~~~
  46.     DorMENU     - Same batch file to run DorMENU, different name (PCB directory
  47.                   The remainder of the files should be put in a doors directory
  48.     DorMENU.EXE - Main executable file to be placed in other than PCB directory
  49.     DorMENU.DOC - These Pulitzer quality docs (hey, watch your language!)
  50.     DorMENU.CNF - Sample config file - must be in same directory as the .exe
  51.     Arcade.DAT  - Sample dat file - must be in same directory as the .exe
  52.     Arcade(g)   - Sample menu file - must be in same directory as the .exe
  53.     Motu        - Sample batch file - must be in same directory as the .exe
  54.     Order.Doc   - How to get a registered version of DorMemu
  55.     and other misc sample files from our bbs
  56.  
  57.     DorMENU Configuration:
  58.     ~~~~~~~ ~~~~~~~~~~~~~
  59.  
  60.        The DorMENU.CNF file must contain the following information:
  61.  
  62.        line  1 = Driver type (HANDSHAKE, INTERRUPT, BIOS, PCBTRAP)
  63.        line  2 = Welcome message filename     \
  64.        line  3 = Main menu filename            \__ PCB color codes supported
  65.        line  4 = Closing door message filename /
  66.        line  5 = Name of BAT file to actually run door
  67.        line  6 = Name of DAT file that contains doors to run
  68. *-->   line  7 = Name of LOG file - Added in version 2.10   <---*
  69.        line  8 = Name of BBS
  70.        line  9 = Name of Sysop
  71.        line 10 = Serial nbr
  72.        line 11 = Registration nbr
  73.  
  74.  
  75.        It will look similar to this:
  76.          INTERRUPT
  77.          dwelcom
  78.          ARCADE
  79.          dclose
  80.          arcade.bat
  81.          arcade.dat
  82. *--->    arcade.log  <---*    PLEASE NOTE THE NEW LINE in version 2.10
  83.          Modem Zone
  84.          Don & Lana
  85.          00000
  86.          00000000
  87.  
  88.        The configuration file must be located in the default directory
  89.      (i.e. C:\PCB\DOORS\ARCADE or whatever) along with the DorMENU.exe file.
  90.  
  91.     Invocation Batch File:
  92.     ~~~~~~~~~~ ~~~~~ ~~~~
  93.  
  94.        As you most likely already know, PCBoard uses batch files associated
  95.     with each door to take care of changing directories, executing the file,
  96.     returning the user to PCBoard, etc. An example of the batch file to use
  97.     for DORMENU, called CASINO, is included.  In addition, DorMENU will look
  98.     for the batch files to run the selected doors in the default (DorMENU)
  99.     directory.  This is so you can run multiple DorMENUs.
  100.  
  101.     Placement of DorMENU files:
  102.     ~~~~~~~~~ ~~ ~~~~~~~ ~~~~~
  103.        1) Customize (edit) DORMENU (the batch file), for your system and
  104.           put it in the BBS directory.
  105.        2) Place DORMENU.EXE in your DOORS directory (i.e.
  106.           \PCB\DOORS\ARCADE).
  107.        3) Customize DORMENU.CNF (the config file), for your system and
  108.           put it in your DOORS directory (must be in same directory as
  109.           DORMENU.EXE).
  110.        4) Place all the batch files to run selected door in the same
  111.           directory as DORMENU.EXE and DORMENU.CNF.
  112.        5) Be sure to add CASINO (or what ever you called the file) to
  113.           your DOORS.DAT file.
  114.  
  115.           Example of DORMENU invocation file (place in bbs default dir):
  116.           ~~~~~~~ ~~ ~~~~~~~ ~~~~~~~~~~ ~~~~
  117.    @echo off                          <- Turns screen off
  118.    c:                                 <- Change to DorMenu drive
  119.    cd\pcb\doors\arcade                <- Change to DorMenu directory
  120.    if exist arcade%PCBNODE%.bat del arcade%PCBNODE%.bat
  121.                                       ^- Clean up any old batch files
  122.    dormenu arcade.cnf C:\pcb          <- runs DorMenu
  123.                       ^----------------- use this for PCBoard.sys
  124.                       C:\WC\DOOR.SYS  <- use this for DOOR.SYS
  125.                       ^----------------- where ever door.sys is located
  126.    if exist arcade%PCBNODE%.bat arcade%PCBNODE%.bat
  127.                                       ^- runs the selected door
  128.                                          which will be copied to this file
  129.    c:                                 <- return to bbs
  130.    cd\pcb                             <- change to bbs directory
  131.    if exist event.bat event           <- check for pending event
  132.    board                              <- brings bbs back on line
  133.   ** NOTE **
  134.       PCBNODE is used only if you are running a multi-node system
  135.       ie.. SET PCBNODE = 1   --- when DorMenu runs PCBNODE will be
  136.                                  changed by DOS to say 1, so the
  137.                                  line above would say ARCADE1.BAT
  138.                                  at execution time.
  139.                          ie..... if exist arcade1.bat arcade1.bat
  140.  
  141.           Example of Batch file (MOTU) to run DorMENU selection:
  142.           ~~~~~~~ ~~ ~~~~~ ~~~~  ~~~~  ~~ ~~~ ~~~~~~~ ~~~~~~~~~
  143.    @echo off               <- Turns screen echo off
  144.    c:                      <- changes to selected door drive
  145.    cd\pcb\doors\pb203      <- Changes to selected door subdirectory
  146.    pbexec PBUSTPRM.TXT     <- Runs selected door
  147.    pbplay PBUSTPRM.TXT     <- Runs selected door
  148.    C:                      <- changes back to bbs drive
  149.    cd\pcb                  <- changes back to bbs directory
  150. -> if exist door.bat door  <- if this file exist then DorMenu will reload
  151.    board                   <- else the bbs will reload
  152.  
  153.           Example of Dat file (Arcade.Dat) to run DorMENU selection:
  154.           ~~~~~~~ ~~ ~~~ ~~~~  ~~~~~~~~~~~ ~~ ~~~ ~~~~~~~ ~~~~~~~~~
  155.           MOTU,10,30
  156.              |  |  ^------------ security level to access door
  157.              |  |_______________ time remaining required to access door
  158.              |__________________ file name to load in to the batch
  159.                                  file to run the selected door.
  160.           TradeWar,,30
  161.           PBuster,,30
  162.           STrek,,30
  163.           Amoeba,,30
  164.           OOII,,30
  165.           DarkStrm,30,30
  166.           MegaVers,,30
  167.  
  168.     Distribution Information:
  169.     ~~~~~~~~~~~~ ~~~~~~~~~~~
  170.  
  171.        You are free to copy and give this program to anyone, but we ask that
  172.     you please keep all the files unchanged in the archieve. To receive your
  173.     registered version of the program, see Order.Doc in this ZIP.
  174.  
  175.        If you have any problems or questions, please call us voice (the
  176.     number is is in the ORDER.DOC) and let us know. The latest release
  177.     of DorMenu and our other door programs are always available for D/L.
  178.        
  179.        Well, that's it! We hope you find DorMenu useful!
  180.   
  181.                                                      Thanks,
  182.                                                  ->Don and Lana<-
  183. Revision history:
  184.  
  185. 05-25-92    v2.10  Added log file to capture caller info while in program.
  186.                    Fixed problem with not appending node number on PCB
  187.                    systems. Fixed problem with invalid PCBOARD.SYS file.
  188.                    Added new line to config files for log name.
  189. 10-25-91    v2.01  Fixed the comm problem with DOOR.SYS. Fixed the
  190.                    time problem with DOOR.SYS.
  191.                    If you use DOOR.SYS or any of the other non-PCB
  192.                    systems you must set the following enviroment
  193.                    string:
  194.                           COMM 1 --> SET COMBASE=1016
  195.                                      SET COMRIQ=4
  196.                           COMM 2 --> SET COMBASE=760
  197.                                      SET COMRIQ=3
  198.                           COMM 3 --> SET COMBASE=1000
  199.                                      SET COMRIQ=4
  200.                           COMM 4 --> SET COMBASE=744
  201.                                      SET COMRIQ=3
  202.                    DorMenu will handle up to 8 comm ports
  203.  
  204. 09-30-91    v2.00  Added support for DOOR.SYS, Updated the doc files,
  205.                    Added .DAT file format to allow security and time
  206.                    checking before allowing caller to open door.
  207. 07-01-91    v2.00  Beta started
  208. 07-16-90    v1.51  Compiled using ProKit 3.2 release, and add close down
  209.                    door.
  210. 03-04-90    v1.5   Fixed dropped carrier problem, minimized opening screen
  211.                    in registered versions.
  212. 02-26-90    v1.4   Added support for registered SysOps by popular request
  213. 01-01-90    v1.3   Compiled using Turbo Pascal 5.5, ProKit 3.1, and a minor
  214.                    bug that caused an occasional door to return to the main
  215.                    board on exit.
  216. 01-23-89    v1.2   Compiled using Turbo Pascal 5.0
  217. 01-05-89    v1.1   Minor bug fix in SysOp Display.  Added printer logging.
  218.                    Now allows User-defined batch file name so DorMENU could
  219.                    now be run from the PCB directory without conflict.
  220. 12-26-88    v1.0   Initial coding
  221.  
  222.